home *** CD-ROM | disk | FTP | other *** search
/ MIDICraft's MIDINET CD-ROM / MIDICraft's MIDINET CD-ROM.iso / DOSUTILS / MIDI2TO0.DOC < prev    next >
Text File  |  1995-10-21  |  4KB  |  119 lines
  1.         ******************************
  2.             MIDI2TO0 v1.0
  3.     
  4.            midi binary format 2 to 0
  5.               by Guenter Nagler 
  6.                 1995 
  7.           (gnagler@ihm.tu-graz.ac.at)
  8.         ******************************
  9.  
  10. [0] FEATURES
  11.     + reads a binary midi file of format 2 (needs to be valid)
  12.     + writes some binary midi files of format 0
  13.  
  14. [1] BACKGROUND
  15. Many midiplayers are not able to play midi format 2, mine too.
  16. Midi format 2 contains one or more multichannel tracks that should
  17. be played sequentially (that means more than one song in a file).
  18. Even if this format is very rarely used it could happen that 
  19. we get a midi of this format and then we will be lucky to be able
  20. converting it to something that we can hear.
  21.  
  22. [2] FILES DESCRIPTION
  23.  
  24. MIDI2TO0.EXE.........converter program
  25. MIDI2TO0.DOC.........this file, showing usage of MIDI2TO0.EXE
  26. MIDIIO.HPP...........header file for a c++ midi parser
  27. MIDIIO.CPP...........source code for a c++ midi parser
  28. MIDI2TO0.CPP.........c++ source code for midi 2 to 0
  29. MIDI2TO0.MAK.........make file for project 
  30. MIDI2TO0.CFG.........compiler options for make
  31. MIDI2TO0.PRJ.........compiler project for borland c++ compilers
  32. only MIDI2TO0.EXE is required to run program
  33.  
  34. [3] COPYRIGHT
  35.  
  36. MIDI2TO0 (c) 1995 was created by Guenter Nagler.
  37.  
  38. MIDI2TO0 is free and may be used as you wish with this one exception:
  39.  
  40.     You may NOT charge any fee or derive any profit for distribution
  41.     of MIDI2TO0.  Thus, you may NOT sell or bundle MIDI2TO0 with any 
  42.     product in a retail environment (shareware disk distribution, CD-ROM,
  43.     etc.) without permission of the author.
  44.  
  45. You may give MIDI2TO0 to your friends, upload it to a BBS, or ftp it to
  46. another internet site, as long as you don't charge anything for it.
  47.  
  48. [4] DISCLAIMER
  49.  
  50. MIDI2TO0 was designed to handle 100% compatible midi files.
  51. So I give no guarantees that the output of program will contain
  52. errorfree 100% compatible midi files.
  53.  
  54. Use MIDI2TO0 at your own risk.  Anything you do with MIDI2TO0 is your
  55. responsibility, and not the author's.  Any damage caused to any person,
  56. computer, software, hardware, company, or business by running MIDI2TO0 
  57. is your responsibility, and the author will not be liable.
  58.  
  59. If you don't understand these terms, or are not sure of something, or
  60. are afraid something bad might come of using MIDI2TO0, don't  use  it!
  61. You are here forewarned.
  62.  
  63. [5] INSTALLATION
  64.  
  65. [MSDOS]
  66. Simply copy MIDI2TO0.EXE in a directory that is in your path.
  67. When you start the program without arguments
  68.  
  69. C:\> MIDI2TO0
  70.  
  71. you should get the usage text (see next section)
  72.  
  73. [UNIX]
  74. compile sources with your C++ compiler (e.g. GNU Compiler g++):
  75.  
  76. g++ -o midi2to0 midi2to0.cpp midiio.cpp
  77.  
  78. and run program
  79.  
  80. $ midi2to0
  81.  
  82. [6] USAGE
  83.  
  84. usage: MIDI2TO0 [-q][-prefix out] midi2fmt.mid 
  85.  
  86. The parts in brackets [...] are optional.
  87.  
  88. The program MIDI2TO0 allows following option:
  89. -q            be quiet,  program does not show percentage
  90.  
  91. -prefix out   generates output files of form out#.mid where # is the 
  92.           extracted track number.
  93.  
  94. MIDI2TO0 does not convert files that are not of format 2!
  95.  
  96. Warning:
  97.   Use -prefix option to generate outputfiles that do not exist!
  98.   Otherwise existing files will be overwritten!
  99.       
  100. [8] SUGGESTIONS / COMMENTS / BUG REPORTS / QUESTIONS
  101.  
  102.          WWW:    http://hgiicm.tu-graz.ac.at/Cpub
  103.           contains all my dos/unix midi programs
  104.          EMAIL:  gnagler@ihm.tu-graz.ac.at
  105.  
  106. [9] USE
  107. For example, you have a midi file example.mid that you expect to be format 2.
  108.  
  109. midi2to0 -prefix foo example.mid
  110.  
  111. If it is not a format 2 midi, the program will stop with a message like that:
  112.    "This file is midi format 2. Its format 1."
  113.  
  114. If it is a format 2 midi it will try to split all tracks:
  115. writing foo1.mid 
  116. writing foo2.mid
  117. writing foo3.mid
  118.  
  119.